home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / hf / dxer / read.me < prev   
Text File  |  1990-02-27  |  10KB  |  236 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 The DXer
  12.  
  13.                                 By WA6JOO
  14.  
  15.                            19279 Santa Ana Ave
  16.                           Bloomington, CA   92316
  17.  
  18.                                  (c)1990
  19.  
  20.  
  21.  
  22.  
  23. 1. Introduction
  24.  
  25.      The DXer concentrates several functions of interest to the
  26. serious DXer into one (hopefully) easy-to-use program.
  27.  
  28.           A:  Bearing and Distance from Transmitter to Receiver.
  29.  
  30.           B:  Sunrise, Noon, Sunset times for any location
  31.  
  32.           C:  Maximum Useable Frequency and Frequency of Optimum
  33.           Traffic between any two locations.
  34.  
  35.           D:  A listing of all locations sharing a common terminator
  36.           line (Gray Line).
  37.  
  38.           E:  Prints custom bearing/distance charts for any location.
  39.  
  40.           F:  A grid locator function using the Maidenhead coordinate
  41.           system.
  42.  
  43.           E:  A complete data base of all ARRL countries as well as
  44.           other locations around the world.  The data base shows
  45.           latitude, longitude,  continent and CQ zone of each
  46.           location.  Entries may be easily added, deleted or edited.
  47.  
  48. 2.  SYSTEM REQUIREMENTS
  49.  
  50.           IBM PC, XT, AT or close clone with 384k memory.  A math
  51.           coprocessor is highly recommended although not required.  If
  52.           you have no coprocessor, be prepared to wait a while for
  53.           some calculations, especially for the Gray Line.
  54.  
  55.           Monochrome, CGA, EGA, VGA monitor.  You may have some
  56.           readability difficulties if you use a composite b/w monitor
  57.           with a color board, since there is no way to disable color
  58.           with this combination.
  59.  
  60.           One 360K floppy drive.  All data is kept in memory so,
  61.           except when loading or modifing the data base, there is no
  62.           real advantage to a hard disk.  If you have one, by all
  63.           means use it.
  64.  
  65.           This program was developed on an 8MHz IBM AT and a 10MHz
  66.           clone and runs correctly on both machines.  There is no
  67.           machine specific code in the program so it should run on any
  68.           100% BIOS compatible.
  69.  
  70.  
  71.           A Printer is not required but, if available, many of the
  72.           data tables may be printed.
  73.  
  74. 3.  GENERAL
  75.  
  76.      The program is written in MicroSoft QuickBasic 4.0/4.5 and
  77. contains approximately 3000 lines of code.  The algorithms used in
  78. some of the calculations were extracted from many sources and I make
  79. no claim of originality for them except for the implementation in
  80. QuickBasic.
  81.  
  82.      The program was written for my own use and to become proficient
  83. in the QuickBasic language and represents literally hundreds of hours
  84. of programming time.  I am releasing the program into the public
  85. domain for individual use and enjoyment only!  Permission for any
  86. commercial use is expressly denied.  If you find this program to be
  87. useful, a small (10$ or so) donation would be appreciated, however, if
  88. you choose not to make a donation,  I doubt if I'll lose any sleep
  89. over it.
  90.  
  91. 4.  PROGRAM DESCRIPTION
  92.  
  93.      The program is completely menu driven and is generally self
  94. explanatory.  A couple of items to remember:
  95.  
  96.      a:  When entering latitudes and longitudes, use decimal degrees,
  97.      not dd,mm,ss format.  Preceed latitudes south of the equator with
  98.      a minus(-) sign.  Preceed longitudes east of Greenwich with a
  99.      minus(-) sign.
  100.  
  101.      b:  When running the program for the first time, you will be
  102.      prompted to create a Configuration file.  This file contains your
  103.      home latitude and longitude and the formfeed code for your
  104.      printer. Once the file has been created, it may be changed at any
  105.      time from the FILE UTILITIES menu.
  106.      If no printer is available, the BEARING TABLE function will not
  107.      show on the main menu and the print function will not show on the
  108.      PROPAGATION FORECAST and SUNRISE-SUNSET selections.
  109.  
  110.      c:  Two copies of the database file and the configuration file
  111.      are maintained by the program.  If the main file is damaged,
  112.      simply go into DOS and rename the main file to some other name
  113.      then rename the backup file to the primary name.  The program
  114.      will create a new backup file.
  115.  
  116.      d:  When running the program, the active keys are shown at the
  117.      bottom of the screen.
  118.  
  119.      e:  A moderate amount of error checking is done on any user input
  120.      although some types of errors are impossible to trap.  If you
  121.      make a mistake on entry, use the backspace key to edit.
  122.  
  123.      f:  From any menu, use the up and down cursor keys to move the
  124.      highlite bar.  Press the Enter key to select.
  125.  
  126.      g:  The Escape key will always back up to the previous logical
  127.      page.
  128.  
  129.      h.  The program reads the system clock for local time and
  130.      converts to UTC as required for calculations.  If you don't have
  131.      a real-time clock be sure to set your system clock using the DOS
  132.      Time and Date functions before running the DXer.  The Program
  133.      recognizes Daylight Savings Time and European Summer Time.  DST
  134.      begins on the first Sunday in April and Ends on the last Sunday
  135.      in October.  EST begins on the last Sunday in March and ends on
  136.      the last Sunday in September.  If your location does not observe
  137.      one of these time changes, enter "N" at the appropiate prompt
  138.      when creating your Config. file.  If some other time schedule is
  139.      observed at your QTH, you will have to make your own correction
  140.      by reseting your system clock.
  141.  
  142. 5.  MENU DESCRIPTIONS
  143.  
  144.      A:  BEARING-DISTANCE
  145.  
  146.           Shows both short and long path bearings and distances from a
  147.      transmitter location (most often your home QTH) and a receiver
  148.      location.  The receiver location may be specified by prefix,
  149.      latitude/longitude, grid square, or chosen from the data base.
  150.           When selecting by prefix, all locations with a common prefix
  151.      will be shown.
  152.  
  153.      B:  PROPAGATION FORECAST
  154.  
  155.           Transmitter and receiver locations are selected as above. 
  156.      MUF calculations are by the MiniMUF '85 algorithm with an initial
  157.      hop length of 4000km.  Actual hop length and number of hops are
  158.      changed by the program so that the path between transmitter and
  159.      receiver is an even number of hops.  Since a 4000km hop length is
  160.      very difficult to achieve due to the extremely low radiation
  161.      angle required, the program will not extend the hop length beyond
  162.      4000km for calculations.
  163.           The FOT calculations are based on the calculated MUF with
  164.      corrections based on absolute sunspot number, UTC time, and
  165.      season.  FOT will generally be somewhere between 80 and 90% of
  166.      MUF.
  167.  
  168.           The calculated values from the program have been checked
  169.      against the output from several other programs avaliable in the
  170.      public domain as well as the propagation curves published monthly
  171.      in QST.  The plotted curves are in general agreement although I
  172.      have not observed point by point agreement between any two
  173.      programs.  The output from The DXer seems to agree reasonably
  174.      well with observed propagation conditions on the bands.
  175.  
  176.           Since the ionosphere has a long time constant, a 5 to 10 day
  177.      smoothed (average) solar flux number will generally give more
  178.      believable numbers.  No allowance is made for disturbed
  179.      conditions since I have yet to see an algorithm to do this.  If I
  180.      ever find one, I will certainly add it to the program.
  181.  
  182.           The radial MUF calculations are from a transmitter location
  183.      to receiver locations at a given distance from the transmitter on
  184.      bearings from 0 to 350 degrees from the transmitter.  Maximum
  185.      number of hops is 5 (20000km).
  186.  
  187.      C:  SUNRISE-SUNSET TABLE
  188.  
  189.           Calculates sunrise, noon, and sunset times for the selected
  190.      location over a one month period.  The first calculation is
  191.      always for the current month.
  192.           The noon calculation is handy for determining true north
  193.      from any QTH since a shadow will point to true north at true noon
  194.      at any location in the northern hemisphere.
  195.  
  196.      D: GRAY LINE
  197.  
  198.           Calculates sunrise and sunset for all locations in the data
  199.      base and displays those locations whose sunrise or sunset is
  200.      within plus or minus one-half hour of the transmitter location
  201.      sunrise or sunset.
  202.  
  203.      E:  BEARING TABLE
  204.  
  205.           If you have a printer this routine will print a custom
  206.      bearing-distance table from any location to all locations in the
  207.      data base.  The printout will be in Prefix order and includes all
  208.      countries on the ARRL DXCC countries list as well as any other
  209.      location that you include in the data base.
  210.  
  211.      F:  GRID LOCATOR
  212.  
  213.           This function is mainly useful by you VHF types out there. 
  214.      Grid coordinates use the Maidenhead system as described in the
  215.      RSGB VHF handbook.  You may identify a grid square by entering
  216.      the latitude and longitude or may enter the grad square and
  217.      calculate latitude and longitude.  If the entered coordinates
  218.      should fall on the dividing line between two or more squares, the
  219.      identification will default to the square to the north and/or
  220.      west of the entered location.
  221.  
  222.      G:  FILE UTILITIES
  223.  
  224.           Allows you to maintain the data base.  You may add new
  225.      records, delete records, or edit existing records.  If you change
  226.      the data base in any way, the unchanged version is saved as the
  227.      backup file on disk.  The data base is maintained in order sorted
  228.      by prefix.
  229.           This function also allows creation of the configuration
  230.      file. The config file contains your home latitude and longitude
  231.      and your printer formfeed code.
  232.  
  233. Well, that's about it.  I've pretty well debugged the code but there
  234. is no such thing as a bug free program if it contains more than a few
  235. lines of code.  If you find any significant bugs, drop me a note on
  236. the back of a QSL and I'll fix it.